home *** CD-ROM | disk | FTP | other *** search
/ Amiga News 95 / Amiga News 95.iso / dpat / dpat96 / klondike_adptools_v1.1 / klondike_adptools.doc < prev    next >
Text File  |  1995-04-17  |  15KB  |  372 lines
  1.  
  2.                             Klondike ADPTools v1.1
  3.                     - The ADPro tool kit for Klondike -
  4.                  © Copyright (06.04.95) Lejardinier Olivier
  5.                             All Rights Reserved
  6.  
  7.                         1.) Licence
  8.                         2.) Shareware
  9.                         3.) Installation
  10.                         4.) Introduction
  11.                         5.) Système requis
  12.                         6.) Démarrage
  13.                         7.) Description des programmes ARexx
  14.                         8.) Mises à jour
  15.                         9.) Contacter l'auteur
  16.                        10.) Historique/Nouveautés
  17.  
  18.      Il est conseillé de lire d'une façon ordonnée cette documentation.
  19.  
  20.  --------------------------------------------------------------------------
  21.  
  22.                  Art Department Professional - Release 2.5.0
  23.        Copyright © 1990-1994 ASDG, Incorporated - All Rights Reserved
  24.  
  25.                                  Klondike AGA
  26.               Copyright © REKO Productions - All Rights Reserved
  27.  
  28.                                     ARexx
  29.           Copyright © 1987 by William S. Hawes - All Rights Reserved
  30.  
  31.                                 Installer v1.24
  32.       Copyright © 1985-1992 Commodore-Amiga, Inc. - All Rights Reserved
  33.  
  34.  --------------------------------------------------------------------------
  35.  
  36.                                 1.) Licence
  37.                                -------------
  38.  
  39.  Cette acceptation de licence se rapporte à tous les programmes, à tous les
  40.  manuels  et  disquettes  du  pack 'Klondike ADPTools',  version  1.0  ou 
  41.  supérieure.
  42.  
  43.  Le  non-respect  d'un  ou  plusieurs  des  points  ci-dessous   provoquera
  44.  l'expiration  de  la  licence, c-à-d terminera vos droits d'utiliser ou de 
  45.  manipuler (ex: distribuer) ce pack.
  46.  
  47.  - Le  prix  de vente ne peut être supérieur aux frais de copie du logiciel,
  48.    (support, frais de copie/de port).
  49.  
  50.  - L'archive de Klondike ADPTools doit être distribuée dans son intégralité 
  51.    (programmes, documentations, données annexes, etc...).
  52.  
  53.    La distribution d'une partie de l'archive n'est pas autorisée.
  54.  
  55.  - Aucun  fichiers  contenu  dans  l'archive  Klondike ADPTools ne peut être
  56.    vendu  avec  un produit commercial sans autorisation écrite de la part de
  57.    l'auteur.
  58.  
  59.  - Le contenu global de l'archive Klondike ADPTools ne peut être modifiée en
  60.    aucune façon.
  61.  
  62.    Cependant j'autorise :
  63.     - la recompression  de  cette  archive  avec n'importe quel compresseur.
  64.     - la  traduction  de  cette  documentation  dans une autre langue si et
  65.       seulement si le traducteur traduit rigoureusement cette documentation.
  66.  
  67.       S'il  le  désire,  il pourra me faire parvenir son travail pour que je 
  68.       je  puisse  l'inclure  dans  les futures versions de Klondike ADPTools
  69.       (voir '9. Contacter l'auteur').
  70.  
  71.  - J'autorise tout particulièrement  les  auteurs  de  Klondike  à  intègrer 
  72.    l'archive  Klondike ADPTools avec leur jeu Klondike à la condition  qu'il
  73.    n'en tire aucun bénéfice commercial.
  74.  
  75.  - J'autorise  la  distribution  (sur  disquette  ou  CD-ROM)  de  l'archive
  76.    Klondike ADPTools dans les collections de programmes du domaine  publique
  77.    avec une  préférence pour l'Amiga Library (crée par Fred Fish)  tant  que 
  78.    le distributeur de la dite collection suit scrupuleusement les différents
  79.    points décrits ci-dessus.
  80.  
  81.  L'auteur se réserve le droit d'interdir ou d'interrompre  à n'importe  quel
  82.  moment  la  distribution  à  un distributeur si celui-ci viole, du point de 
  83.  vue du propriétaire du copyright, un ou plusieurs points de cette licence.
  84.  
  85.  Les profits résultants d'une distribution illégale devront être reversés au
  86.  propriétaire du copyright.
  87.  
  88.  L'auteur fournit ce programme "tel quel". Le risque entier de l'utilisation
  89.  de ce programme vous appartient. L'auteur  ne  sera  pas  responsable  des
  90.  dommages  résultant de l'utilisation de son programme, ni,  mais non limité 
  91.  à celles-ci,  des pertes  de données  résultant de l'utilisation directe ou
  92.  indirecte de ce programme.
  93.  
  94.                                 2.) Shareware
  95.                                ---------------
  96.  
  97.  Klondike ADPTools est un programme SHAREWARE :
  98.  
  99.  Si vous utilisez souvent Klondike ADPTools ou tout simplement si vous voulez
  100.  me faire un don, veuillez m'envoyer 20 (ou plus) francs français UNIQUEMENT
  101.  EN ESPECES avec vos coordonnées à l'adresse suivante :
  102.  
  103.                    Lejardinier Olivier - Klondike ADPTools
  104.                                  9 rue Conti
  105.                                76600 Le Havre
  106.                                    France
  107.  
  108.                               3.) Installation
  109.                              ------------------
  110.  
  111.  Pour installer Klondike ADPTools sur votre disque dur, copier le répertoire
  112.  'Klondike_ADPTools'  à  l'endroit  que vous voulez, puis double-cliquer sur
  113.  l'icône 'Install Klondike ADPTools' pour démarrer l'installation.
  114.  
  115.                               4.) Introduction
  116.                              ------------------
  117.  
  118.  Cet  ensemble  de programmes ARexx a été créé à l'attention des utilisateur
  119.  du jeu Klondike voulant créer * FACILEMENT * leurs propres jeux de cartes.
  120.  
  121.  Le principal but à atteindre lors de la création de ces programmes était de
  122.  limiter  au maximun les manipulations de fichiers par l'utilisateur,  ainsi
  123.  que le temps de création d'un jeu de cartes.
  124.  
  125.  Remarque : Une  bonne  connaissance  des documentations du logiciel ADPro et
  126.             du jeu Klondike (notament la section '7. How to make a cardset?')
  127.             est fortement conseillée pour une parfaite compréhension de cette
  128.             documentation.
  129.  
  130.                               5.) Système requis
  131.                              --------------------
  132.  
  133.  Pour fonctionner, ces programmes nécessitent obligatoirement :
  134.  
  135.   - L' OS 3.0 ou supérieur.
  136.   - ARexx.
  137.   - ADPro version 2.5 ou supérieure.
  138.   - Sufisament de mémoire (4Mo de FAST minimum) et bien sûr un disque dur.
  139.  
  140.                                6.) Démarrarage
  141.                               -----------------
  142.  
  143.  Pour  utiliser  les  différents  programme ARexx du pack Klondike ADPTools, 
  144.  vous  dever  démarrer  le  gestionnaire  ARexx  (se  référer au  manuel du
  145.  Workbench pour l'installation et l'utilisation des programmes ARexx), puis
  146.  démarrez ADPro.
  147.  
  148.  Pour  exécuter  un  des programme ARexx, vous devez  double-cliquer dans la
  149.  liste 'User Commands' sur :
  150.  
  151.   0-About.adpro             : pour obtenir des informations sur Klondike 
  152.                               ADPTools.
  153.   1-ScaleCards.adpro        : pour créer des cartes au formats IFF 24Bits
  154.                               86x128.
  155.   2-MakeGlobalPalette.adpro : pour calculer la palette globale des cartes
  156.                               précédement crées.
  157.   3-RenderCardset.adpro     : pour créer le jeu de cartes final.
  158.   4-CreateCardset.adpro     : utilisé uniquement si le programme précédent
  159.                               à échoué. 
  160.  
  161.                     7.) Description des programmes ARexx
  162.                    --------------------------------------
  163.  
  164.  La plupart du temps, vous devrez exécuter les trois programmes ARexx dans
  165.  l'ordre 1-2-3 pour créer un nouveau jeu de cartes.
  166.  
  167.  Note : Le  programme  '4-CreateCardset.adpro'  ne  sera  utilisé  que si le 
  168.         programme '3-RenderCardset.adpro' a échoué : en fait  il vous permet
  169.         de ne refaire que la procédure finale de création du jeu de cartes.
  170.  
  171.  *** NOTE TRES TRES IMPORTANTE *** :
  172.  
  173.   VOUS NE DEVEZ EN AUCUN CAS UTILISER DES CHEMINS D'ACCES COMPORTANT DES
  174.   ESPACES  DANS LEURS NOMS  SOUS PEINE D'UNE INTERRUPTION INOPORTUNE DES
  175.   PROGRAMMES. (bug dans WORD() ???)
  176.  
  177.                          7.1) Préparation des images
  178.  
  179.                          7.2) 0-About.adpro
  180.                          7.3) 1-ScaleCards.adpro
  181.                          7.4) 2-MakeGlobalPalette.adpro
  182.                          7.5) 3-RenderCardset.adpro
  183.  
  184.                          7.6) 4-CreateCardset.adpro
  185.  
  186.  
  187.  
  188.                          7.1) Préparation des images
  189.                         -----------------------------
  190.                             
  191.  Avant  de  pouvoir  créer un nouveau jeu de cartes vous  devez posséder sur
  192.  votre disque dur d'un nombre suffisant d'images de votre choix, d'un format
  193.  et taille quelconque, mais >= à 86x128.
  194.  
  195.  Les posseseurs de scanners peuvents digitaliser directement leurs images au
  196.  format  86x128,  les  sauver  UNIQUEMENT  en  IFF  24  bits et utiliser les
  197.  programmes 2-3.
  198.  
  199.  Sinon, il vous faut :
  200.  
  201.    * 52 images pour les cartes elles-mêmes.
  202.      + 1 image CARD00 = carte 'REKO-Production' (cf doc Klondike).
  203.      + 1 image CARD01 = carte avec seulement un cadre (cf doc Klondike).
  204.  
  205.          -> Pour ces 2 cartes, vous pouvez utiliser celles se trouvant dans
  206.             le répertoire 'Klondike_ADPTools/Templates'.
  207.  
  208.      + 1 image CARD02 = représentant le dos d'une carte (cf doc Klondike).
  209.  
  210.  ceci pour un jeu de cartes 'standard' (55 cartes).
  211.  
  212.  Pour un jeu de cartes 'extra' (59 cartes) il vous faut EN PLUS :
  213.  
  214.      + 1 image CARD55 = carte la plus à gauche en bas de l'écran.
  215.      + 1 image CARD56 = carte au milieu gauche en bas de l'écran.
  216.      + 1 image CARD57 = carte au milieu droit en bas de l'écran.
  217.      + 1 image CARD58 = carte la plus à droite en bas de l'écran.
  218.  
  219.   * 52 images symbôls (pique, coeur, etc...)
  220.  
  221.     -> là  je  vous  conseille  fortement d'utiliser celles fournies dans le
  222.        répertoire 'Klondike_ADPTools/Symbols'.
  223.  
  224.        Le but de Klondike ADPTools n'est pas de perdre son temps à dessiner
  225.        des nouveaux symbôls...
  226.  
  227.  Enfin, pour obtenir un résultat parfait, ces images doivent de préférence
  228.  se conformer aux points suivants :
  229.  
  230.    - elles doivent être 'plus hautes que larges' dans un rapport (idéal) de 
  231.      86/128=0.67 (ex de format : 344x512)
  232.  
  233.    - elles ne doivent pas dèjà contenir de bords noir ou d'une autre couleur
  234.      Si  le  cas  se  présente,  vous  pouvez  charger l'image sous ADPro et
  235.      utiliser 'Operators/Crop_Visual' pour les supprimer, et ensuite sauver
  236.      (de préférence en IFF) l'image.
  237.  
  238.                              7.2) 0-About.adpro
  239.                             --------------------
  240.  
  241.  Ce programme ARexx permet d'obtenir des informations sur Klondike ADPTools.
  242.  
  243.                            7.3) 1-ScaleCards.adpro
  244.                           -------------------------
  245.  
  246.  Ce programme ARexx permet de scaler vos images au format 86x128 puis de les
  247.  sauver en IFF 24 Bits :
  248.  
  249.   - Lancer ce programme sous ADPro
  250.   - Sélectionner des images à scaler (normalement 52)
  251.   - Sélectionner la destination des images scalées
  252.   - Sélectionner le nom de base des images scalées
  253.     ex : Si vous entrer 'Card', les images porteront les noms :
  254.              Card.000
  255.              Card.001
  256.              etc...
  257.  
  258.     Remarques : Le programme  vous  donnera par défaut le nom de base de la
  259.                 première carte sélectionnée.
  260.  
  261.                 Contrairement  à  la  version 1.0  les cartes scalées peuvent
  262.                 être numérotées à partir de 000.
  263.  
  264.                         7.4) 2-MakeGlobalPalette.adpro
  265.                        --------------------------------
  266.  
  267.  Ce programme ARexx permet de calculer la palette globale des images scalées
  268.  avec '1-ScaleCards.adpro' :
  269.  
  270.  - Lancer ce programme sous ADPro.
  271.  - Sélectionner des images scalées au format 86x128 (normalement 52).
  272.  - Entrer le nombre de cartes qui seront utilisées pour calculer la palette.
  273.    
  274.    Note : Le programme vous donnera une valeur courante, calculée automatiquement,
  275.           en fonction de la mémoire disponible.
  276.  
  277.    Ce nombre représente le nombre de ligne de 4 cartes à utiliser.
  278.    Normalement il est égal à 13. (13x4=52 cartes).
  279.  
  280.  - Une fois que la palette a été calculée le programme vous demandera si vous
  281.    voulez définir vous-même la couleur du fond du jeu de cartes ou bien
  282.    utiliser la couleur par défaut.
  283.    
  284.    Si vous choisissez de la définir vous-même, le programme vous demandera 
  285.    les 3 composantes de la couleur.
  286.    
  287.  - Sélectionner la destination et le nom du fichier palette.
  288.  - Vous pouvez ensuite sauver une preview des cartes calculées avec la palette
  289.    globale.
  290.  
  291.    Vous pouvez ainsi visualiser cette image pour déterminer les cartes que
  292.    vous voulez garder.
  293.  
  294.                           7.5) 3-RenderCardset.adpro
  295.                          ----------------------------
  296.  
  297.  Ce programme ARexx permet de créer le jeu de carte final.
  298.  
  299.  NOTE IMPORTANTE : L'outil  'REKO'  fournit  avec  le jeu Klondike doit être
  300.                    installer dans 'C:' (voir '3. Installation').
  301.  
  302.  - Lancer ce programme sous ADPro.
  303.  - Sélectionner  au  minimum 52 fichiers cartes (correspondant  avec  cette 
  304.    palette).
  305.  - Sélectionner une palette globale créée avec '2-MakeGlobalPalette.adpro'.
  306.  - Sélectionner au minimum 52 fichiers symbôls.
  307.  - Sélectionner la destinations des cartes rendues avec la palette.
  308.  - Entrer le nom de base des cartes.
  309.  - Choisisser le type de jeu de cartes :
  310.      55 cartes : jeu standard
  311.      59 cartes : jeu extra
  312.  - Quelque  soit  le type choisi, vous devrez sélectionner les cartes CARD00,
  313.    CARD01 et CARD02 (cf doc de Klondike).
  314.  - Si vous avez choisi le type de jeu extra, vous devez en plus sélectionner
  315.    CARD55, CARD56, CARD57, et CARD59 (cf doc de Klondike).
  316.  - Sélectionner la destination du jeu de cartes.
  317.  
  318.  Voilà,  si  tout  se  passe  bien, c'est fini !! sinon vous serez peut-être
  319.  obligé d'utiliser '4-CreateCardset.adpro'.
  320.  
  321.  Vous  devez  maintenant assigner ce nouveau jeu de cartes à une touche sous
  322.  Klondike, pour cela vous devrez éditer le fichier REKO.Prefs.
  323.  
  324.                           7.6) 4-CreateCardset.adpro
  325.                          ----------------------------
  326.  
  327.  Ce programme  ARexx  NE DOIT  être utilisé que si '3-RenderCardset.adpro' a
  328.  a échoué lors de la création du jeu de cartes.
  329.  
  330.                     8.) Mises à jour de Klondike ADPTools
  331.                    ---------------------------------------
  332.  
  333.  Si  je  continue à développer Kondike ADPTools, les prochaines mise à jour
  334.  seront  disponible  dans  les diverses collections de programmes du domaine
  335.  publique.
  336.  
  337.                             9.) Contacter l'auteur
  338.                            ------------------------
  339.  
  340.  Vous  êtes  libre de m'envoyer des rapports de bogues, des commentaires, ou
  341.  des suggestions, à l'adresse suivante :
  342.  
  343.                    Lejardinier Olivier - Klondike ADPTools
  344.                                  9 rue Conti
  345.                                76600 Le Havre
  346.                                    France
  347.  
  348.                          10.) Historique/Nouveautés
  349.                         ----------------------------
  350.  
  351.  v1.1 (06.04.95) :
  352.  -----------------
  353.  
  354.    - Correction de quelques bugs dans l'affichage des messages.
  355.  
  356.    - Meilleur gestion des erreurs fichier/système.
  357.  
  358.    - Détermination automatique :
  359.       - du nom de base des cartes.
  360.       - du nom de la palette globale.
  361.       - du nom de la preview.
  362.       en fonction du premier fichier sélectionné.
  363.       - du nombre de cartes à utiliser pour le calcul de la palette globale.
  364.  
  365.    - Rajout du programme '4-CreateCardset.adpro' en cas d'échec du programme 
  366.      '3-RenderCardset.adpro'.
  367.    
  368.    - Support  du  programme  Installer   de   Commodore  pour  la   procédure
  369.      d'installation.
  370.  
  371.  v1.0 (22/02/95) : Première version.
  372.